This directory contains binaries and sources for T3.1.  Currently available
versions are for Dec3100(pmax), Sun4(sparc), Sun3, Vax/Unix, Encore, Hp
workstation, Apollo, Next, and Mac/Aux.  

If your machine uses the 680x0 processor (Sun3,Hp,Apollo,Mac,Next) you will
need the files tfix5.t, ofix5.t, and m68fix.t.  You should modify tfix5.t to
load m68fix.t in addition to ofix5.t.  If your machine uses the Vax processor
you need only tfix5.t and ofix5.t.  The shell variable TSYSTEM should be
defined to be the directory containing these files.  You can compile the fix
files if you want to.  Machines based on other processors do not need these
files.

When installing a binary image you may ignore files such as sunbuild.t which
are only used to rebuild a T image from sources.

If retrieving T for Apollos under SR10, be sure to use the Apollo-specific -A
option to tar when unpacking the distribution.  This version works on DN3000's
under SR10.1 and SR10.2.  It does not work on DN3500's.



The T manual is available in 3 forms:
    tman.tar.Z - 5th edition (incorporating T3.0 and T3.1 release notes), in
                 TeX (beta release).
    manual.Z - 4th edition, ASCII text version, readable online.
    doc.tar.Z - 4th edition, Scribe version.

For Sun3, Sparc, Pmax (mips) and Vax you may want foreign.tex which explains 
the C/Unix foreign function interface to T.

Send your e-mail address to t-project@cs.yale.edu so you can be informed of
fixes, new releases, etc.  Bug reports to t3-bugs@cs.yale.edu.  Newsgroup
arpa.t-discussion exists for discussion of T.



The pmax and sparc versions of T3.1 contain the following improvements:

There is a faster garbage collector.  By default it doesn't print anything to
the terminal.  (set (gc-noisily?) '#t) will restore the old behavior.

The compiler writes an additional file (.mld on pmax and .sd on sparc) used to
get local variable information and source for compiled code.  As a result,
most crawl commands work on stack frames for compiled as well as interpreted
code.

There is a new form (TRACE-IF predicate proc-to-trace).  This prints
trace information for proc-to-trace if predicate applied to the arguments
is true.

There are new forms BREAK, UNBREAK, and BREAK-IF corresponding to trace.
Instead of printing trace information they give a breakpoint. (ret) will
continue the computation.  RET with an argument will cause another break after
the procedure returns.